Phase 2: searchable site and printable QR location stickers - #2

Makes the inventory findable. Stacked on #1 — base is phase1-migrate-legacy-inventory, and GitHub will retarget this to main automatically when #1 merges. Review #1 first.

Phase 2 deliberately comes before the add-item forms: search value has to land before anyone is asked to enter data, or this goes the way of the spreadsheet.

What you get

• site/index.html — search UI. Instant search across name, category, notes, owner, vendor, catalog number, and location label, so "fridge door" and "cabinet 3" are queries too. Filters for room / category / status, match highlighting, mobile-first, dark mode.
• scripts/build_site.py — builds _site/index.html.
• scripts/make_qr_labels.py — printable QR sticker sheet, one per location, filterable by room and kind.
• .github/workflows/pages.yml — validate → build → deploy on push to main.

Decisions worth a look

No search library. At 499 items, a precomputed lowercase haystack per item plus a scored linear scan is faster than any index, and there's nothing vendored to keep alive. Every query token must match somewhere; name-prefix scores above name-substring above any-field.

The data is inlined into the HTML, not fetched as a JSON sidecar. That means the built page works over file:// — you can open _site/index.html directly with no local server and no CORS trouble. Cost is a 110 KB page, which is nothing.

QR labels are HTML, not PDF. No PDF toolchain to maintain — open and print. Sticker geometry is CSS variables at the top of the generated file, so it can be nudged to fit real label stock without touching the script.

Location deep links roll up descendants. Scanning the sticker on the -20 freezer shows all 49 items across its shelves and drawers, not the zero items filed directly against the freezer itself. That rollup is the entire point of the QR path — a sticker that showed "0 items" would kill trust in the system immediately.

Two bugs found by loading the page instead of assuming

• The template placeholder was /*__INVENTORY_DATA__*/null but the build substituted only the comment, leaving const DATA = {...}null;. Syntax error, silently blank page — and no console output to hint at it. The placeholder now swallows the null, and the template stays valid JavaScript either way.
• segno's default SVG carries width/height but no viewBox, so the CSS sticker size only enlarged the SVG viewport while the QR stayed at intrinsic size in the corner. omitsize=True emits a viewBox instead.

Both were only visible by actually rendering it, which is why the screenshots were worth taking.

Three legacy warts fixed, spotted in the UI

Seeing real rows on screen surfaced data problems that reading CSVs hadn't:

• Multiple parenthetical dates — the earliest becomes received, the rest are preserved in notes instead of dropped.
• Unbalanced parentheses. The source itself has 2-Mercaptoethanol (8/6/2018) (opened (8/8/2018). Stripping dates left a name ending mid-parenthesis; the orphaned fragment now moves to notes. Zero unbalanced names remain.
• Documentation now outranks content words — DNeasy blood and tissue handbook is office, not a blood sample; sample tubes is a container, not a sample.

items.csv changes in this PR are entirely those three fixes. Counts are unchanged at 499.

Needs one manual step

Settings → Pages → Source = GitHub Actions. The workflow can't enable Pages for the repo itself, so the first deploy will fail until that's set.

Also still pending from #1: branch protection on main requiring Code Owner review, or CODEOWNERS stays documentation rather than a gate.

Verified

Built and loaded in a browser at mobile and desktop widths, light and dark. Confirmed working: search + highlighting (dneasy → 5 hits, prefix matches first), room/category/status filters, #213-F20 rolling up 49 nested items, #209-CAB-10 showing 4, the QR sheet rendering 173 stickers 3-across, and --rooms 213 --kinds drawer narrowing to 60. No console errors. validate.py passes with the one expected warning about room 228 having no locations yet.

🤖 Generated with Claude Code